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INTRODUCTION 


General Description 


SYSTEM/ODI is a normaicstate program which interfaces the system 
to the operator display terminal (CODT)» and manages anciltary 
functions reiated to the ODT. It is toaded by coldstart routines 
and entered into an appropriate name table stots it 1s executed 
automatically by» and onty by» the MCP during the Clear/Start 
processSe Shoutd SYSTEH/OOT terminate for any reason while the 
system 15 runnings the MCP will reinitiate it automatically at 
the next N_SECOND interrupt. The system user 1s largely 
obiivious to the existence of SYSTEM/ODT as a discrete program, 
it may functionaliy be considered to be a subsystem of the MCP 
from which many of its tasks were extracted. 


The functions of SYSTEA/ODI includes 


le Receiving operator input from a CRT terminal» either a 
traditional hard-control ODT or a specially-designated 
terminal in the datacomm network» and deiivering this 
input to tne MCP. 


2 « Receiving messages from the MCP» Including 
| MCP-generated output messages and copies of input 
messages from atl allowable itnput sources such as card 
readers» datacomm>» zips» pseudo readers» and the ODT 
messages in (i). 


a Maintaining a wraparound disk file of the system 
traffic referr to in (€2)» entitted SYSTEM/ODI.QUuUEUE. 


4 e Formatting in various manners some or all of these 
messages» and periodically displaying them upon the 
ODT. 

5. Optionally printing current and past message traffic on 


a tine orinter file. 


6 Maintaining a log of system message traffic» 
SYSTEM/LOG» and periodically or upon operator command 
™"transferring™ this log. This term means that the 


current log is locked in the disk directory and a new 
SYSTEM/LOG opened. Analysis programs can be optionaity 
initiated by SYSTEM/ODT. The transferred tog 1s named 
OCTLOG/<mmddyyhhnmm>» reflecting the date and time of 
transfer. | 
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OPERATING INSTRUCTIONS 


No operating instructions are required for SYSTEM/ODT» as it is 
intended to be a transparent part of the operating system. It is 
executed solely by the MCPs if it as explicitly executed ody a 
user » it witli go immediateiy to EQJ with an appropriate error 
diagnostic.e The only operator commands which are ultimately 
executed by SYSTEM/ODT ianctude ait "K8" commandsse the "CQ" 
command» and commands such as “7Si™” and "LG" related to the 
ODILQGs; this fact is not apparent to the system operatore 


Program Switches 


SYSTEM/BDT is sensitive to one program switch in the reiease 
versione and two in a special debug development version. The 
highworder bit of program switch 3» 1.2. SWC0) >= Br if set at 
BOJ» tells SYSTEN/ODTI to ignore the “hard” ODT» if an ODT control 
is presente and to use a remote datacomn terminat for the ODT. 
Setting the switch is superfluous if the system does not have a 
hard OvT. Program switch 4s effective only in debug versions of 
SYSTEM/ODT» controts a trace of internal operation of SYSTEXH/OOT 
to file TRACE_FILE described betouw. 
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FILES 


Information below on the file dectarations in SYSTEM/ODT is 
presented for referencee Critical file attributes in these files 
are set dynamically by SYSTEM/ODI>» ensuring that user attampts at 
modification do not cause system failures. 


LINE 315 a printer file upon which tistings of system message 
traffic produced with the "K8 LP ON™ £eoperator command are 
produced. Attributes (NAM» backup designations etc.) of the LINE 
file are userc-modifiable. 


Q IN» external name “SP90.Q.FILE"™» is a queue file used to receive 
message traffic from the wcP. it 3S protected against access 
from any other program. | 


Q OUT» external name "ODT_Q_ FILE"» is a queue fiie through whicn 
operator input 1s passed to the MCP. It is protected against 
access from any other program. 


ODT Q» external name “"SYSTEM/O0DT.QUEUE"s is the wraparound disk 
file containing the most recent message traffic. It defaults to 
200 segments but can be changed in size with the "KB SIZE" 
operator command. [t 15 accessible inputtonly to other programs» 
and is copied into SYSTEM/DUMPFILE when a system memory dump is 
takene The first record of this file is a header record> tne 
remaining records contain the most recent system messages in a 
pseudo variadlesiangth=record format. SYSTEM/ODT does not» in 
the interest of efficiency» actuattly open and do togicali [1/0 to 
this file except undo certain specialized circumstances; it 
Duilds 1/0 descriptors and dispatches through GISMO» avoiding the 
fogical I/0 subsystem. 


GDTLOG» external name "SYSTEM/ODTLOG"» is a disk file of system 
message tratfic maintained when the ODTL option is in effect, 
Records appear identically to those in SYSTEM/ODT.QUEUE>» but the 
files does not wrap around. : | 


RMT» external name "“OPERATOR"» is a remote file representing a 
datacomm terminal used as the ODT in the absence of a ™hard™ ODT. 
It is required to be on the towest muitin-line port» and to have 
an address of "38". 


TRACE_FILE> external name "“QDOT_TRACE"/<unique I1D>» 1s a 
wraparound trace file of internal program operation present only 
in special debugging versions of SYSTEM/ODI. It is’ intended for 
development use only. The debugging trace is dynamicatiy turned 
on and off by setting and resetting the ltowctorder bit of program 
SWitch 4e 
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ODT QUEUE DATA FORMATS 


The following formats» 


are identical to 


presented in SDL2 syntax» 
to programs that wish to access SYSTEM/ODT.QUEUE. 
ODT queue formats» 


will be useful 
ODDTLOG formats 
With the exception of the 


absence of the JDT queue header record. 


SET DISPLAY HODES 


RECORD COORDINATE 
REC 
DISP 


RE TORD 
1 ODT O_ MSG_HOR_LAYOUT 

LEN 
CONTINUATION 
COMPLETE 
INPUT_SOURCE 
TIME AND_DATE 

3 FILLER 

3 TIME_LENGUEUED 

3 DATE_LENQUEUED 


NM MN BR he 


RECORD OOT_@_FIRST_REC 
NOTZERO 
QUEUE_LEVEL 


HEAD 

TAIL 

MIN_DAD 
MAX _ DAD 
INPUT_LINES 
OUTPUT_LINES 
KB_LP_ON 
ODT_DIRN 
DISPLAY_TIME 
ODT SUPPRESS 
OoTL_ OPTION 
ODILOG_KEY 
OOTLOG_SEGHENTS_PER_AREA 
ENQ_ GROUP_SIZE 
DESPLAY_MODE 


= M5G_MOQDE >» 


GROUP_MODE>» 
PAGE_MODES 


BITC8)>» 424% relative record 
SITC12)>5 4242 displacement tin bits 


BLT(56)° 
BITC 11d» “24% tn bitse including header 
BOOLEAN» %42% True => carried over 
BOOLEAN» 2244 True => end of this message 
BLT(3)>» 44% sea CITRL_CARD_DRIVER in NCP 
BITC40)» 224 onty if NOT CONTINUATION 
BLT{(4)> | 
BITL 20)» 422% tenths of second > midnight 
BITC1i6)» 44% 7 bits years» 9 bits Jday 
BLIC24)» “44% always adFFFFFFa 
BIT(24)» 42% prog=disk compatability 

Tota he 


check. Currently ?. 
COORDINATE» 2244 gotta display from here 
COORDINATE» 422% enqueue starting here 
BLITC36)e% DAD 

B17°36)»% DAD 

BSITC4)» 

BIT(5)>, 

BOULEAN> 

BOOLEAN» 

BOOLEAN» 

BOOLEAN?» 

BOOLEAN» 

BLICZ4)» 

BIT(16)» 

BLT(6)>» 

MEMBER OF DISPLAY_MODES> 


Sa! 
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MEMORY REQUIREMENTS 


SYSTEM/ODT is frozen tin memory due to its need to point to 
certain aosolute system structures without the constant overhead 
of recalculating tneir displacements outside 1ts own bDbaserLimit 
sSpacee Memory usage is a dynamic function» and the following 
estimates are at best imperfect. The sizes below are subject to 
change as new capanilities are added or programming modifications 
Made e 


RSN and environment 83782 bits 
File space 15640 bits 
Typicaliyw-resident code 62816 bits 
segment dictionary 1940 bits 
Total 193278 bits €20409 oytes) 


Options such as "KB LP ON" and “™OQDTL"™ cause additional memory 
usage due to the additional open files and the code needed to 
manage these options within SYSTtCH/ODI. 
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